home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / qm4ext.arc / DSZ.DOC < prev    next >
Encoding:
Text File  |  1991-04-29  |  13.7 KB  |  331 lines
  1.  
  2.  
  3.  
  4.      DDDDSSSSZZZZ((((1111))))                XXXXEEEENNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOMMMMEEEENNNN))))                DDDDSSSSZZZZ((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           dsz - ZMODEM, YMODEM, XMODEM PC-DOS file transfer subprogram
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ddddsssszzzz [CCCCOOOONNNN] [ppppoooorrrrtttt NNNN] [ssssppppeeeeeeeedddd SSSS] [hhhhaaaannnnddddsssshhhhaaaakkkkeeee oooonnnn] [dddd] _c_o_m_m_a_n_d
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           _D_s_z uses the ZMODEM, YMODEM, or XMODEM protocol to transfer
  16.           files over a serial port with a variety of programs.
  17.  
  18.           ZMODEM Transfers support 32 bit CRC, transfer recovery, and
  19.           advanced file selection.
  20.  
  21.           YMODEM transfers preserve the exact file length and
  22.           modification date/time with the information in the YMODEM
  23.           header block 0.
  24.  
  25.           _D_s_z supports XMODEM-1k (XMODEM with 1024 byte blocks,
  26.           sometimes mislabeled YMODEM) and CRC-16 with the _s_x -_k and
  27.           _r_c commands.
  28.  
  29.           _D_s_z is derived from Omen Technology's Professional-YAM
  30.           communications software, (also published by POLYTRON Corp of
  31.           Hillsboro Oregon as PowerCom(TM)), and supports a subset of
  32.           Pro-YAM's file transfer related commands.
  33.  
  34.           _D_s_z is designed to be called from a communications bulletin
  35.           board program.  _D_s_z may also be called from other
  36.           communications programs, but the combination lacks many
  37.           amenities of a communications program with seamless ZMODEM
  38.           support.
  39.  
  40.           _D_s_z uses its own modem I/O.  The original interrupt vector,
  41.           UART interrupt configuration, and 8259 interrupt mask are
  42.           restored on exit.
  43.  
  44.           _D_s_z uses standard DOS output for messages, it does not write
  45.           directly to the screen.  _D_s_z expects its standard output to
  46.           point to the console, a logging file, or NULL, not the modem
  47.           port.  If necessary, _d_s_z'_s standard output may be redirected
  48.           to the console device with the CCCCOOOONNNN command.
  49.  
  50.           _D_s_z exits with 0 status for successful transfers, 1 if a
  51.           file transfer failed.
  52.  
  53.      CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  54.           _D_s_z commands are an improper subset of Pro-
  55.           YAM/PowerCom/ZCOMM commands.  Except as noted, all commands
  56.           must be in lower case.  Please refer to the ZCOMM, PowerCom,
  57.           or Pro-YAM manual for details.  Unlike ZCOMM and Pro-YAM,
  58.           _d_s_z does not support Kermit and ZMODEM AutoDownload, ZMODEM
  59.           command download and ZMODEM security challenge.  _D_s_z does
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 7/2/87)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      DDDDSSSSZZZZ((((1111))))                XXXXEEEENNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOMMMMEEEENNNN))))                DDDDSSSSZZZZ((((1111))))
  71.  
  72.  
  73.  
  74.           not support Kermit, Super Kermit, B Protocol, the
  75.           traditional XMODEM variants MODEM7, Telink, WXMODEM, and
  76.           Clink/SEAlink supported by Pro-YAM/PowerCom/ZCOMM.
  77.  
  78.           When used, the _C_O_N, _p_o_r_t, _s_p_e_e_d, _h_a_n_d_s_h_a_k_e, and _d commands
  79.           must be given in the order shown.
  80.  
  81.           CCCCOOOONNNN  Redirect message output to the DOS "CON" (console)
  82.                device, overriding any previous redirections.
  83.           hhhhaaaannnnddddsssshhhhaaaakkkkeeee oooonnnn
  84.                Enable RTS/CTS hardware handshake.  (The default is
  85.                XOFF/XON software handshake).
  86.           ppppoooorrrrtttt NNNN
  87.                select port N (n = 1,2,3 or 4) Default is port 1 (COM1)
  88.                or read from the DDDDSSSSZZZZPPPPOOOORRRRTTTT dos environment variable.
  89.           ssssppppeeeeeeeedddd SSSS
  90.                Set the specified speed.  This command is rarely needed
  91.                because _d_s_k reads the port's current speed by default.
  92.                Please refer to to the _M_A_I_N _C_O_M_M_A_N_D_S and _S_O_F_T_W_A_R_E
  93.                _C_O_E_X_I_S_T_E_N_C_E chapters in the ZCOMM or Pro-YAM manual for
  94.                important information about the _s_p_e_e_d command.
  95.           dddd    Disables carrier dropout monitoring, for modems that do
  96.                not properly drive the "Data Carrier Detect" input on
  97.                the PC.
  98.           LLLLAAAARRRRGGGG Convert AAAARRRRGGGG to lower case, then parse aaaarrrrgggg....
  99.           ppppxxxxNNNN  Set a numeric parameter xxxx to N.  These parameters are a
  100.                subset of the Pro-YAM or ZCOMM numeric parameters, and
  101.                are listed below.  They assume their defaults each time
  102.                _d_s_z is called.  Without an argument, pppp displays the
  103.                numeric parameters and their values.
  104.           zzzz ppppxxxxNNNN
  105.                Set zmodem numeric parameter xxxx to N.  These parameters
  106.                correspond to the Pro-YAM or ZCOMM "zmodem" parameters
  107.                and rarely need changing.  These parameters assume
  108.                their defaults each time _d_s_z is called.  Without an
  109.                argument, zzzz pppp displays the zmodem numeric parameters
  110.                and their values.
  111.           rrrreeeessssttttrrrriiiicccctttt
  112.                Restrict pathnames to current disk and directory tree.
  113.           sssszzzz   [-abnpr+y] [PREFIX=p | ONAME=n] file ...(ZMODEM or
  114.                YMODEM)
  115.           ssssbbbb   [-k] [PREFIX=p | ONAME=n] file ...      (YMODEM or
  116.                ZMODEM)
  117.           ssssxxxx   [-k] file1                    (XMODEM or XMODEM/CRC)
  118.           rrrrzzzz   [-abnpr+y] [dir] [file ...]   (ZMODEM)
  119.           rrrrbbbb   [-ab+y] [dir] [file ...]      (YMODEM)
  120.           rrrrbbbb ----gggg
  121.                [-ab+y] [dir] [file ...]      (YMODEM-G)
  122.           rrrrcccc   [-ab+y] file1                 (XMODEM/CRC)
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 7/2/87)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      DDDDSSSSZZZZ((((1111))))                XXXXEEEENNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOMMMMEEEENNNN))))                DDDDSSSSZZZZ((((1111))))
  137.  
  138.  
  139.  
  140.           rrrrxxxx   [-ab+y] file1                 (XMODEM)
  141.  
  142.      PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  143.           _D_s_z uses the following main numeric parameters, settable
  144.           with the _p_x_N command.  In addition, _d_s_z uses the Pro-
  145.           YAM/ZCOMM _z_m_o_d_e_m numeric parameters described in the Pro-
  146.           YAM/ZCOMM manual.
  147.  
  148.           BBBB    Set the size of buffer used for disk reads and writes.
  149.                The default is 1024, 16384 maximum.  A larg value may
  150.                give better results when sending files to or from from
  151.                sluggish floppy disk systems.  Too large a value will
  152.                exhaust memory or induce receiver timeouts.  This
  153.                parameter is supported on versions compiled with
  154.                TurboC.
  155.  
  156.           SSSS    Timeout after  seconds waiting for XON
  157.  
  158.           aaaa    Calibrates protocol timeouts used with handshaking and
  159.                XMODEM and YMODEM transfers (Cybernetic Data
  160.                Recovery(TM)).  The aaaa numeric parameter is
  161.                automatically set to 2000 for a 4.77 mHz PC or XT, 4000
  162.                for a PS2/30, 6000 for an 8 mHz 1ws AT, and 12000 for a
  163.                PS2/80.  If your computer has a speedup card or
  164.                otherwise runs unusually fast (or slow!) for its type,
  165.                you should set the aaaa numeric parameter to a value that
  166.                reflects its speed.
  167.  
  168.           oooo    If non zero, allow concurrent disk/port activity
  169.  
  170.           vvvv    Verbose level (debugging output) Negative values
  171.                inhibit some routine messages
  172.  
  173.           zzzz    Timezone in minutes behind GMT
  174.  
  175.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  176.           dsz sz c:foo.* b:*.c          (send files)
  177.  
  178.           dsz sz -r zmodem.arc          (resume interrupted transfer)
  179.  
  180.           dsz sz -n *.*                 (send files that are newer or
  181.           rx has no copy)
  182.  
  183.           dsz sz -Yn *.*                (send files that are newer and
  184.           rx has copy)
  185.  
  186.           dsz rz C:/UPLOADS             (receive files to specified
  187.           directory)
  188.  
  189.           dsz port 2 speed 38400 restrict rz
  190.  
  191.           dsz rz  -y prog.arc           (ZMODEM, single file pathname
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 7/2/87)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      DDDDSSSSZZZZ((((1111))))                XXXXEEEENNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOMMMMEEEENNNN))))                DDDDSSSSZZZZ((((1111))))
  203.  
  204.  
  205.  
  206.           override)
  207.  
  208.           DSZ LRZ L-Y NEWPROG.ARC       (generate lower case "rz -y"
  209.           command)
  210.  
  211.           dsz z pr1 rx foo.dat          (XMODEM receive, remove file
  212.           on error)
  213.  
  214.           dsz pv2 sz foo >debug.dmp     (Debugging data dump)
  215.  
  216.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  217.           Consult the Professional-YAM, PowerCom, or ZCOMM manual
  218.           chapter "Options for File Transfers" for option meanings.
  219.           The "File Transfer Basics" chapter explains the relative
  220.           merits of the XMODEM, YMODEM, and ZMODEM protocols.  The
  221.           "Main Commands" chapter describes the rb, rx, rc, rz, sb,
  222.           and sz commands.
  223.  
  224.           Information on the ZMODEM _I_n_t_e_r _A_p_p_l_i_c_a_t_i_o_n _F_i_l_e _T_r_a_n_s_f_e_r
  225.           _P_r_o_t_o_c_o_l may be found in ZMODEM.DOC, part of ZMODEM.ZOO.
  226.  
  227.           C Source code for XMODEM, YMODEM, and ZMODEM transfers is
  228.           included in RZSZ.ZOO.  This file includes a Pro-YAM/ZCOMM
  229.           script to upload a bootstrap file to a Unix system, force
  230.           its compilation, and (if the compilation is successful)
  231.           upload the rz/sz source files.
  232.  
  233.      NNNNOOOOTTTTEEEESSSS
  234.           Some programs claiming to support YMODEM do not send or
  235.           accept the YMODEM pathname block.  1024 byte XMODEM is
  236.           XMODEM-1k, not YMODEM.  _D_s_z sets the UART shift register to
  237.           8 bits no parity; the original UART parity setting (if
  238.           different) is not restored on exit.
  239.  
  240.           32 bit CRC code courtesy Gary S. Brown.
  241.  
  242.           Cybernetic Data Recovery, Error Containment, OverThruster,
  243.           Password Guardian, CryptoScript, and TurboDial are Omen
  244.           Technology trademarks.
  245.  
  246.           PowerCom is a trademark of POLYTRON Coprporation, Hillsboro
  247.           Oregon.
  248.  
  249.      FFFFIIIILLLLEEEESSSS
  250.           ZCOMMDOC.ARC, ZCOMMEXE.ARC, ZCOMMHLP.ARC, ZMODEM.ZOO,
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                           (printed 7/2/87)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      DDDDSSSSZZZZ((((1111))))                XXXXEEEENNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOMMMMEEEENNNN))))                DDDDSSSSZZZZ((((1111))))
  269.  
  270.  
  271.  
  272.           RZSZ.ZOO
  273.  
  274.      LLLLIIIICCCCEEEENNNNSSSSEEEE
  275.           _D_s_z is written by Chuck Forsberg.  _D_s_z may not be modified
  276.           or sold without the written permission of Omen Technology
  277.           Inc.  _D_s_z may be freely used and copied by bulletin board
  278.           systems which feature the ZCOMM files (ZCOMMEXE.ARC,
  279.           ZCOMMDOC.ARC, ZCOMMHLP.ARC) for unrestricted downloading.
  280.           _D_s_z may be registered by sending your bulletin board's
  281.           telephone number and a valid login to
  282.  
  283.                                         Omen Technology Inc.
  284.                                         P.O. Box 4681
  285.                                         Portland, OR 97231.
  286.  
  287.           _D_s_z registration and a diskette with current versions of the
  288.           ZCOMM files will be mailed upon validation.
  289.  
  290.           Other users may register their copy of _d_s_z with a check for
  291.           $20.00 sent to the same address.
  292.  
  293.      CCCCHHHHAAAANNNNGGGGEEEESSSS
  294.           Protocol transfer timing has been modified to depend less on
  295.           the "a" numeric parameter.  The procedure described in the
  296.           YAM/ZCOMM manual for adjusting the "a" numeric parameter is
  297.           no longer valid, and should not be used.
  298.  
  299.           Versions after March 1987 buffer both transmitted and
  300.           received data, providing enhanced throughput with multi
  301.           tasking systems such as DESQview.
  302.  
  303.           Versions compiled with _T_u_r_b_o_C support the BBBB numeric
  304.           parameter and code to allow file sharing on transmitted
  305.           files.
  306.  
  307.           The BBBB numeric parameter now supports both transmitted and
  308.           received files.
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                                           (printed 7/2/87)
  328.  
  329.  
  330.  
  331.